home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / polymo.z / polymo
Encoding:
Text File  |  2002-10-03  |  6.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ppppoooollllyyyymmmmoooo((((3333GGGG))))                                                          ppppoooollllyyyymmmmoooo((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppoooollllyyyymmmmoooo - control the rendering of polygons
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ppppoooollllyyyymmmmoooo((((mmmmooooddddeeee))))
  13.      iiiinnnntttteeeeggggeeeerrrr****4444 mmmmooooddddeeee
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _m_o_d_e   Expects one of the symbolic constants:
  17.  
  18.             PPPPYYYYMMMMPPPPOOOOIIII, draw only points at the vertices.
  19.  
  20.             PPPPYYYYMMMMLLLLIIIINNNN, draw lines from vertex to vertex.
  21.  
  22.             PPPPYYYYMMMMFFFFIIIILLLL, fill the polygon interior.
  23.  
  24.             PPPPYYYYMMMMHHHHOOOOLLLL, fill only interior pixels at the boundaries.
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      ppppoooollllyyyymmmmoooo specifies whether polygons are filled, outlined, drawn with points
  28.      at their vertices, or outlined with a hollow fill algorithm.  Affected
  29.      polygons include all polygons that are normally filled, including those
  30.      generated by bbbbggggnnnnppppoooollll and eeeennnnddddppppoooollll, by bbbbggggnnnnttttmmmmeeee and eeeennnnddddttttmmmmeeee, by bbbbggggnnnnqqqqsssstttt and
  31.      eeeennnnddddqqqqsssstttt, by aaaarrrrccccffff, cccciiiirrrrccccffff, and rrrreeeeccccttttffff, and by NURBS surfaces.  Also affected
  32.      are polygons generated by the obsolete ppppmmmmvvvv, ppppddddrrrr, and ppppcccclllloooossss commands, and
  33.      by ppppoooollllffff and ssssppppoooollllffff.
  34.  
  35.      PPPPYYYYMMMMFFFFIIIILLLL is the default mode.  In this mode polygons are filled with a
  36.      point-sample algorithm.  (Refer to the Graphics Library Programmer's
  37.      Guide for an detailed explanation of point-sampling.)
  38.  
  39.      PPPPYYYYMMMMPPPPOOOOIIII causes a single point to be drawn at each polygon vertex,
  40.      including vertices generated by clipping.  All point rendering modes,
  41.      including antialiasing specified by ppppnnnnttttssssmmmmoooo, apply to these points.
  42.  
  43.      PPPPYYYYMMMMLLLLIIIINNNN causes lines to be drawn from vertex to vertex around the
  44.      perimeter of the polygon.  This line forms a single outline, because it
  45.      passes through both projected vertices and vertices generated by
  46.      clipping.  All line rendering modes, including line width, line stipple
  47.      style, and line antialiasing specified by lllliiiinnnneeeessssmmmm, apply to these lines.
  48.  
  49.      PPPPYYYYMMMMHHHHOOOOLLLL supports a special kind of polygon fill with the following
  50.      properties:
  51.  
  52.      1.   Only pixels on the polygon edge are filled.  These pixels form a
  53.           single-width line (regardless of the current lllliiiinnnneeeewwwwiiii) around the
  54.           inner perimeter of the polygon.
  55.  
  56.      2.   Only pixels that would have been filled (PPPPYYYYMMMMFFFFIIIILLLL) are changed (i.e.
  57.           the outline does not extend beyond the exact polygon boundary).
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ppppoooollllyyyymmmmoooo((((3333GGGG))))                                                          ppppoooollllyyyymmmmoooo((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      3.   Pixels that are changed take the _e_x_a_c_t color and depth values that
  75.           they would have had the polygon been filled.
  76.  
  77.      Because their pixel depth values are exact, hollow polygons can be
  78.      composed with filled polygons accurately.  Both hidden-line and scribed-
  79.      surface renderings can be done taking advantage of this fact.
  80.  
  81. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  82.      bgnpol, endpol, polysm, stenci
  83.  
  84. NNNNOOOOTTTTEEEESSSS
  85.      XS, XZ, Elan, and Extreme graphics support all ppppoooollllyyyymmmmoooo options except
  86.      ppppoooollllyyyymmmmoooo((((PPPPYYYYMMMMHHHHOOOOLLLL)))).  IRIS-4D G, GT, and GTX models, as well as the Personal
  87.      Iris, Iris Entry, Indy, and XL systems do not support ppppoooollllyyyymmmmoooo.  Use ggggeeeettttggggddddeeee
  88.      to determine whether support for ppppoooollllyyyymmmmoooo is available.
  89.  
  90. BBBBUUUUGGGGSSSS
  91.      In order to support polygon fill mode PPPPYYYYMMMMHHHHOOOOLLLL, IRIS-4D VGX and
  92.      RealityEngine models require that the following conditions be met:
  93.  
  94.      1.   Stencil planes be allocated (at least one plane).
  95.  
  96.      2.   The stencil planes be initialized to zero prior to drawing hollow
  97.           polygons.
  98.  
  99.      3.   The stencil planes be used for no other purpose while drawing hollow
  100.           polygons.  (The stencil function is controlled by the hardware and
  101.           must not be user specified.)
  102.  
  103.      IRIS-4D VGX models have an error in their microcode that results in
  104.      matching errors between pixels generated by PPPPYYYYMMMMFFFFIIIILLLL and PPPPYYYYMMMMHHHHOOOOLLLL in some
  105.      conditions.  This error will be corrected in the next software release.
  106.  
  107.      PPPPYYYYMMMMHHHHOOOOLLLL is not supported on Impact or Infinite Reality.
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.